To add a new route:

1 Copy the section starting with <node name="Default Route"> and ending with </node> and paste it below the Default Route section.

<node name="routes">

<map />

<node name="Default Route">

<map>

<entry key="value" value=".*" />

<entry key="attribute" value="origination" />

<entry key="url" value="http://localhost:51080/vxml/audio/test-30sec.vxml" />

<entry key="priority" value="1" />

<entry key="language" value="vxml" />

</map>

</node>

2 Change the name of the pasted section to a unique name.

3 Change the call route parameters as needed.

Parameter

Description

attribute

Valid attributes are:

n Origination – The originating phone number

n Destination – The destination phone number

n ChannelID – The channel ID (for example, XL Line 121)

n PortID – The port ID (for example, 1, 2, 3, ...)

value

The value parameter corresponds to a regular expression value of the specified attribute. For example, if the attribute is origination, the value could be a regular expression of a phone number that matches a specific area code. If the attribute is channelID, the value could be something like XL Line 121. The attribute/value combination is used by the Vocalocity Voice Browser to determine if the current call can be satisfied by the given call route.

To specify a wildcard value for an origination or destination phone number, use "/d*". For example, to create a route that handles all phone numbers with an area code of "404", enter a value of "404/d*".

priority

Used to match calls when multiple call routes match. Matches the highest priority first, followed by the lower priorities, down to 1.

language

VXML

URL

The URL for the call route

Call Routing for Failover and Load Balancing

You can set up call routes in the vocalos-node.xml file to handle failover situations and for load balancing purposes.

To set a call route for failover, edit a call route and add a space and second http location in the URL. For example, the URL entry for failover looks like the following:

<entry key="url" value="http://webserver/start.vxml" "http://webserver/start2.vxml" />

To set up call routes for load balancing, you can add multiple call routes on different servers. Incoming calls use round-robin strategy to hit the different servers for load balancing purposes. The URL for each server is different, but the value, attribute, priority, and language are the same. For example, the configuration values for two call routes on different servers looks like the following:

Configuration Values

Call Route 1

Call Route 2

value

.*

.*

attribute

origination

origination

url

http://webserver1/start.vxml

http://webserver2/start.vxml

priority

1

1

language

vxml

vxml

The combination of the value, attribute, priority, and language is a unique key to group together multiple URL routes.